Skip to content

Add packet-bound documentation and PR workflow with complete worker contracts - #17

Merged
Zacharon merged 2 commits into
mainfrom
local/aeos-doc-workflow-20261113
Nov 17, 2026
Merged

Zacharon merged 2 commits into
mainfrom
local/aeos-doc-workflow-20261113

Conversation

@Zacharon

Copy link
Copy Markdown
Owner

Two commits from the 2026-11-13 documentation pilot:

  1. Include complete contracts in bounded worker handoffs. Adds prototypes/issue_handoff/WORKER_CONTRACT.md and pins it, by hash, into the issue-handoff bundle, so a worker receives the full return and rationale schema instead of a link.
  2. Add the packet-bound documentation and PR workflow. prototypes/issue_handoff/documentation_workflow.py adds lint, history, prepare, check and verify over a context-selection fence in an existing v1.2 packet, reusing the frozen public.4 validators. Includes docs/DOCUMENTATION_PR_WORKFLOW.md, an example packet, 22 tests, and two new CI steps in issue-handoff.yml.

Checks run locally (Windows, Python 3.14.5):

  • python -B -m unittest discover -s tests -p test_documentation_workflow.py -v: 22 tests, OK
  • python -B -m unittest discover -s tests -p test_issue_handoff.py -v: 29 tests, OK (main: 27, OK). An earlier run under a 300 s timeout showed one F before it was killed; the full run passed. That test may be sensitive to timing under load.
  • python -B prototypes/issue_handoff/documentation_workflow.py lint --root . --packet prototypes/issue_handoff/documentation-task.md: exit 0

The whole diff was read for private names, machine paths and secrets; none found. Draft because prototypes/issue_handoff/README.md keeps merging and owner acceptance as the owner's decision, separate from CI. Non-blocking: a dedented comment under the else: branch in inspect() (cosmetic).

🤖 Generated with Claude Code

AEOS local review added 2 commits November 13, 2026 06:10
Locally prepared review layer; no publication or owner acceptance.
Locally prepared review layer; no publication or owner acceptance.
@Zacharon
Zacharon marked this pull request as ready for review November 17, 2026 09:53
@Zacharon
Zacharon merged commit 1100a25 into main Nov 17, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant